home *** CD-ROM | disk | FTP | other *** search
/ Skunkware 5 / Skunkware 5.iso / man / cat.1 / waisserver.1 < prev    next >
Text File  |  1995-07-27  |  6KB  |  199 lines
  1.  
  2.  
  3.  
  4.      WWWWAAAAIIIISSSSSSSSEEEERRRRVVVVEEEERRRR((((1111))))  TTTThhhhiiiinnnnkkkkiiiinnnngggg MMMMaaaacccchhhhiiiinnnneeeessss ((((TTTTuuuueeee AAAApppprrrr 22228888 1111999999992222))))  WWWWAAAAIIIISSSSSSSSEEEERRRRVVVVEEEERRRR((((1111))))
  5.  
  6.  
  7.  
  8.      NNNNAAAAMMMMEEEE
  9.           waisserver - serves WAIS requests
  10.  
  11.  
  12.      SSSSYYYYNNNNOOOOPPPPSSSSIIIISSSS
  13.           wwwwaaaaiiiisssssssseeeerrrrvvvveeeerrrr [ -p [ port_number ] ] [ -s ] [ -d directory ]
  14.           [ -e [ pathname ] ] [ -l log_level ] [-u user ] [ -v ]
  15.  
  16.           wwwwaaaaiiiisssssssseeeerrrrvvvveeeerrrr....dddd
  17.                [ same arguments ]
  18.  
  19.  
  20.      DDDDEEEESSSSCCCCRRRRIIIIPPPPTTTTIIIIOOOONNNN
  21.           Part of the Wide Area Information Server system.
  22.  
  23.           waisserver will take WAIS requests from a TCP port or
  24.           standard-io and return the appropriate response.  If the
  25.           name of the command is waisserver.d, then it is assumed it
  26.           is running from inetd, and it uses stdio for its I/O
  27.           sockets.  See the examples below for inetd.conf.
  28.  
  29.           In addition, waisserver can act like an anonymous FTP
  30.           server.  When the server is given a document of type "FTP"
  31.           as a relevant document, it will build a result list from the
  32.           directory of the file.  Subdirectories may be listed using
  33.           by adding them to the relevant document list.
  34.  
  35.           Note that a minimal level of security is present in two
  36.           forms:
  37.  
  38.           1.  The server will never present directories above the
  39.           default server directory (-d option, described below).
  40.  
  41.           2.  The server will only build a directory listing from a
  42.           file of type FTP, and that file must be in the specified
  43.           database.
  44.  
  45.  
  46.      OOOOPPPPTTTTIIIIOOOONNNNSSSS
  47.           ----pppp [ _p_o_r_t ]
  48.                     Listen to the port.  If the port is supplied, then
  49.                     that port number is used.  If it is not supplied
  50.                     then the Z39.50 port (210) is used.
  51.  
  52.           ----ssss        listen to standard I/O for queries.
  53.  
  54.           ----dddd _d_i_r_e_c_t_o_r_y
  55.                     Use this directory as the default location of the
  56.                     indexes.  Therefore if the directory were
  57.                     /usr/local, then the database foo would be found
  58.                     in /usr/local/foo (see waisindex for how to create
  59.                     an index)
  60.  
  61.  
  62.  
  63.      Page 1                                          (printed 7/27/95)
  64.  
  65.  
  66.  
  67.  
  68.  
  69.  
  70.      WWWWAAAAIIIISSSSSSSSEEEERRRRVVVVEEEERRRR((((1111))))  TTTThhhhiiiinnnnkkkkiiiinnnngggg MMMMaaaacccchhhhiiiinnnneeeessss ((((TTTTuuuueeee AAAApppprrrr 22228888 1111999999992222))))  WWWWAAAAIIIISSSSSSSSEEEERRRRVVVVEEEERRRR((((1111))))
  71.  
  72.  
  73.  
  74.           ----eeee [ _f_i_l_e_n_a_m_e ]
  75.                     Redirect error output to pathname, if supplied, or
  76.                     to /dev/null.  Error output defaults to stderr,
  77.                     unless -s is selected, in which case it defaults
  78.                     to /dev/null.
  79.  
  80.           ----llll _l_o_g__l_e_v_e_l
  81.                     set logging level.  Currently only levels 0, 1, 5
  82.                     and 10 are meaningful: Level 0 means log nothing
  83.                     (silent).  Level 1 logs only errors and warnings
  84.                     (messages of HIGH priority), level 5 logs messages
  85.                     of MEDIUM priority (like client init info).  Level
  86.                     10 logs everything.
  87.  
  88.           ----uuuu _u_s_e_r   Set the server's user id to the user specified
  89.                     after attaching the tcp-port. This is only used if
  90.                     the server is started as root.
  91.  
  92.           ----vvvv        Print the current version and date of the server.
  93.  
  94.      EEEEXXXXAAAAMMMMPPPPLLLLEEEESSSS
  95.           The following are examples of _w_a_i_s_s_e_r_v_e_r usage:
  96.  
  97.           waisserver -p 8000 -d wais-sources -e server.log
  98.                Runs waisserver as a standalone server, using tcp port
  99.                8000 on directory wais-sources writing messages to
  100.                server.log
  101.  
  102.           Some example inetd.conf entries (note, these must be on one
  103.           line in inted.conf):
  104.  
  105.           hpux 7.0/800, Interactive/386 2.2.1:
  106.  
  107.           z3950 stream tcp nowait root /etc/waisserver waisserver.d
  108.            -d /wais-sources -e /server.log
  109.  
  110.           Ultrix 4.1:
  111.  
  112.           z3950 stream tcp nowait /etc/waisserver waisserver.d
  113.            -d /wais-sources -e /server.log
  114.  
  115.           Also, add the next line to /etc/services, and tickle your YP
  116.           server:
  117.  
  118.           z3950 210/tcp # wide area information server (wais)
  119.  
  120.      SSSSEEEEEEEE AAAALLLLSSSSOOOO
  121.           waissearch(1), waisindex(1), waissearch-gmacs(1), xwais(1),
  122.           xwaisq(1), inetd(8C), inetd.conf(5)
  123.  
  124.           Wide Area Information Servers Concepts by Brewster Kahle.
  125.           Brewster@think.com
  126.  
  127.  
  128.  
  129.      Page 2                                          (printed 7/27/95)
  130.  
  131.  
  132.  
  133.  
  134.  
  135.  
  136.      WWWWAAAAIIIISSSSSSSSEEEERRRRVVVVEEEERRRR((((1111))))  TTTThhhhiiiinnnnkkkkiiiinnnngggg MMMMaaaacccchhhhiiiinnnneeeessss ((((TTTTuuuueeee AAAApppprrrr 22228888 1111999999992222))))  WWWWAAAAIIIISSSSSSSSEEEERRRRVVVVEEEERRRR((((1111))))
  137.  
  138.  
  139.  
  140.      DDDDIIIIAAAAGGGGNNNNOOOOSSSSTTTTIIIICCCCSSSS
  141.           The diagnostics produced by the waisserver are meant to be
  142.           self-explanatory.
  143.  
  144.      BBBBUUUUGGGGSSSS
  145.           Malformed protocol packets can cause the server to dump core
  146.           (segmentation violation).  These are logged in the server's
  147.           log file.
  148.  
  149.  
  150.  
  151.  
  152.  
  153.  
  154.  
  155.  
  156.  
  157.  
  158.  
  159.  
  160.  
  161.  
  162.  
  163.  
  164.  
  165.  
  166.  
  167.  
  168.  
  169.  
  170.  
  171.  
  172.  
  173.  
  174.  
  175.  
  176.  
  177.  
  178.  
  179.  
  180.  
  181.  
  182.  
  183.  
  184.  
  185.  
  186.  
  187.  
  188.  
  189.  
  190.  
  191.  
  192.  
  193.  
  194.  
  195.      Page 3                                          (printed 7/27/95)
  196.  
  197.  
  198.  
  199.